From 4401be22ad6c492137307dc0efdce8a9cb257e1a Mon Sep 17 00:00:00 2001 From: Carlos Garnacho Date: Tue, 8 Apr 2014 21:27:08 +0200 Subject: [PATCH] enums: Document GtkPropagationPhase --- gtk/gtkenums.h | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h index 77983d2ad6..88770715a3 100644 --- a/gtk/gtkenums.h +++ b/gtk/gtkenums.h @@ -1049,6 +1049,24 @@ typedef enum GTK_INPUT_HINT_INHIBIT_OSK = 1 << 7 } GtkInputHints; +/** + * GtkPropagationPhase: + * @GTK_PHASE_NONE: Events are not delivered automatically. Those can be + * manually fed through gtk_event_controller_handle_event(). This should + * only be used when full control about when, or whether the controller + * handles the event is needed. + * @GTK_PHASE_CAPTURE: Events are delivered in the capture phase. The + * capture phase happens before the bubble phase, runs from the toplevel down + * to the event widget. This option should only be used on containers that + * might possibly handle events before their children do. + * @GTK_PHASE_BUBBLE: Events are delivered in the bubble phase. The bubble + * phase happens after the capture phase, runs from the event widget, up to + * the toplevel. + * + * Describes the stage at which events are fed into a #GtkEventController. + * + * Since: 3.14 + */ typedef enum { GTK_PHASE_NONE, -- 2.30.2